markdown 语法

Posted on | In
花了两天，正儿八经的学了一下，在没有熟练前至少有个顺手的笔记查一查~

[搬文+再整理] Markdown 语法手册

文本结构

分级标题

代码：

1
2
3
4
5
# 一级标题
## 二级标题
### 三级标题
···
###### 六级标题

显示效果：

一级标题

二级标题

三级标题

···

六级标题

列表

1) 有序列表

代码：

1
2
3
1. 有序列表项（编号后至少有一个空格）
2. 有序列表项（编号后至少有一个空格）
3. 有序列表项（编号后至少有一个空格）

显示效果：

  1. 有序列表项
  2. 有序列表项
  3. 有序列表项

2) 无序列表

代码：（星号可以由 + 或 - 替代）

1
2
3
* 有序列表项
* 有序列表项
* 有序列表项

显示效果：（此处尝试三种符号混用）

  • 有序列表项
  • 有序列表项
  • 有序列表项

列表格式

列表格式部分其实没有理清，实践积累后再更。

一个列表项下有多个段落，默认这些段落都属于这个列表，段落有缩进。如何修改这种缩进,方法未知。

一篇文档内，若存在多个列表，列表间以空行隔开（列表项间不能用空行隔开，不然就认为是两个列表）。实际使用中其实将每一个列表间都空行隔开，有序列表注意手动改序号就好了，哈哈。

定义结构

由名词及其解释组成，第一行为名词，第二行为解释。

代码：

1
2
Markdown
:   轻量级文本标记语言，可以转换成html，pdf等格式（冒号+Tab）

显示效果：这里的显示格式似乎受到主题影响。

Markdown
轻量级文本标记语言，可以转换成html，pdf等格式（冒号+Tab）

引用

引用受主题影响，原引用不是这个样子的T^T，等以后自己搞懂了改回来~

代码：

1
> 这是一句引用

显示效果：

这是一句引用

多行引用可以只在第一行加 > ，代码：

1
2
3
> 这是一句引用
这是一句引用
这是一句引用

显示效果：

这是一句引用
这是一句引用
这是一句引用

所以，引用段落后若要直接跟普通段落，以空行隔开。

引用可以嵌套，但同样注意空行隔开，代码：

1
2
3
4
5
>>> 这是一句引用

>> 这是一句引用

> 这是一句引用

显示效果：

这是一句引用

这是一句引用

这是一句引用

列表项中段落若出现引用，有可能会出混乱，此处未解决。

字体修饰：粗体、斜体、删除线

代码：

1
2
3
4
5
**粗体**
*斜体*
_斜体_
***加粗斜体***
~~删除线~~

显示效果（然后发现本主题下没有细的斜体…）：

粗体
斜体
斜体
加粗斜体
删除线

常用元素添加

链接

1) 行内式（常用）

格式为：[链接文字](链接地址 “链接标题”)。
链接地址与链接标题间有一个空格。链接标题即title属性，可加可不加，其效果是鼠标悬停在链接上会出现指定的 title文字。

代码：

1
[百度一下](http://baidu.com "baidu")

显示效果：

百度一下

2) 参考式

参考式链接分为两部分，文中为：[链接文字][链接标记]；具体链接地址可在文本的任意位置添加：[链接标记]:链接地址 “链接标题”。

代码：

1
2
我经常使用[百度][1]。
[1]:http://baidu.com "百度一下"

显示效果：

我经常使用百度。

3) 自动链接

多用于简短的地址，如网址和电子邮件信箱。

代码：

1
<http://baidu.com>

显示效果：

http://baidu.com

锚点

页内超链接，只支持在标题后插入锚点。在你准备跳转到的指定标题后插入锚点，然后在文档的其它地方写上连接到锚点的链接。

代码：

1
2
3
4
## 某标题{#index}
···
···
跳转到[某标题](#index)。

显示效果：暂无。

图像

1) 行内式

格式：![图片Alt](图片地址 “图片Title”)，图片Alt的意思是如果图片因为某些原因不能显示，就用定义的图片Alt文字来代替图片。图片Title表示鼠标悬停与图片上时出现的文字。 Alt和Title都不是必须的，可以省略。

示例：暂无。

2) 参考式

形式类似超链接参考式，在文档要插入图片的地方写：![图片Alt][图片标记]，在文档任意位置（建议文末）写上：[图片标记]:图片地址 “图片Title”

示例：暂无。

目录

在所需位置（建议文首）新增一行[TOC]，则按标题生成目录。

本博客主题中只需要在“头信息”中设置toc: true即可。

代码

行内代码由 ` 包裹，整块代码由前后两行的三个 ` 包裹。

代码：

1
控制台输出 `console.log("hello!")`

显示效果：

控制台输出 console.log("hello!")

代码：摘不出……

整块显示效果：

1
2
console.log("hello!");
//控制台输出

表格

语法说明：第一行为表头，第二行用于分隔表头和主体部分，第三行开始为表格内容。表格的列之间用管道符 | 隔开，表格左右两侧可省略。第二行还可以设置列的对齐方向，默认左对齐，在 - 右侧加 : 即为右对齐。

代码：

1
2
3
4
5
产品|价格
-|-:
普通账户|10元/年
高级账号|120元/年
超级账号|1200元/年

显示效果：

产品 价格
普通账户 10元/年
高级账号 120元/年
超级账号 1200元/年

公式

本博客主题需要在./_config.yml中先配置mathjax: true，然后在文稿“头信息”里也配置mathjax: true，就可以生效啦~

1) 行内公式

代码：

1
质能守恒方程：$E=mc^2$

显示效果：

质能守恒方程：$E=mc^2$

2) 整行公式

代码：

1
$$\sum_{i=1}^n a_i=0$$

显示效果：

$$\sum_{i=1}^n a_i=0$$

具体的公式编辑语言尚待研究……其实不咋会用的吧，呵呵。

其他

\

用于将格式字符变成一般显示字符，强大。

空行

用于打断格式，比如列表、引用等，强大且重要！

分隔线

在一行中用三个以上的星号或减号来建立分隔线，行内不能有其他东西，符号间可以有空格。

代码：

1
2
3
4
5
6
7
XXX
***
XXX
---
XXX
* * * *
XXX

显示效果：（分隔线一致，分割字体有差：* 是细字，- 是粗字）

XXX

XXX

XXX

XXX

HTML

直接加在文档里，可以自动识别，就是如果再搞点复杂的css甚至js有没有什么分出来写的方法，哈哈。

暂时就到这里吧看到转载文档下有条评论，关于markdown的语言规范，下次有空可以再整理整理